home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / pcb / copydsc2.zip / COPYDESC.DOC < prev    next >
Text File  |  1992-11-15  |  2KB  |  60 lines
  1. COPYDESC version 1.02        Copyright (C) 1992 by Jim Robeson
  2.                                                    11/15/92
  3. Function:
  4.    Read a PCBoard DIR LIST file (arg-1),
  5.      and copy it to a file (arg-2),
  6.      changing all multi-line descriptions to "long lines".
  7.      with the output position of the '|' set in arg-3,
  8.      and the starting position of the text set in arg-4.
  9.    note: requirment:   1 < arg-3 < arg-4 <= 34
  10.  
  11. Other uses:
  12.    None.
  13.  
  14. Execution:
  15.    Run from command line or .BAT:
  16.    COPYDESC drv:\path\in-file-name drv:\path\out-file-name |pos txtpos
  17.    If run without arguments, a bit of help appears.
  18.  
  19. To test:
  20.    See the file TESTID.BAT, it is set up to read DIR.IN and create
  21.    DIR.OUT, with the '|' character in column 2 and the secondary
  22.    descriptions starting in column 5.
  23.  
  24. Notes:
  25.    This version will blow up if more than 39-40 lines are found in
  26.    any single file description.  If a "hang" is experienced, check
  27.    the input file for really long descriptions.  You could lower the
  28.    number of lines!  If I continue to modify this, I will add a test
  29.    for this condition.  Meanwhile, now you know too!
  30.  
  31.    The test for the "first-line" of a description includes:
  32.       a numeric in column 21,
  33.       a '-' in each of 26 & 29,
  34.       and an "acceptable" DOS filename character in column 1.
  35.  
  36.    If all 3 of the above conditions are met in any given line, the
  37.    program will assume that the line is the first line of a new
  38.    description.
  39.  
  40.    If a description is entirely ignored (not reformatted), or is
  41.    merged into the previous description, a check for those conditions
  42.    will probably show the reason.  BTE, the '&' is not acceptable to
  43.    me, even if DOS allows it part of the time!
  44.  
  45.    Oh yes, BTW, the description data in line one is NOT re-packed, it
  46.    is taken as-is.  Words might get added to line 1, though.
  47.  
  48. Disclaimer:
  49.    This program is contributed to the Public Domain.  It can be
  50.    freely used, modified and/or distributed by anyone. The only
  51.    thing I ask is that you remember that I am not responsible
  52.    for anything that might go wrong through the use of this
  53.    program.  I have tested the program enough for my own use.
  54.    I also realize that bugs can appear in most every program.
  55.    Therefore, YOU USE THIS PROGRAM AT YOUR OWN RISK.
  56.  
  57. Enjoy,
  58. Jim Robeson
  59. The Cricket BBS, Pacific Grove CA,  408-373-3773
  60.